<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
            "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>



<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.08">
<LINK rel="stylesheet" type="text/css" href="embroot.css">
<TITLE>
Getting Started
</TITLE>
</HEAD>
<BODY >
<A HREF="embroot041.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="embroot043.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>

<H2 CLASS="section"><A NAME="htoc72">8.1</A>&nbsp;&nbsp;Getting Started</H2><UL>
<LI><A HREF="embroot042.html#toc32">Check your Java SDK version</A>
<LI><A HREF="embroot042.html#toc33">Make the <TT>com.parctechnologies.eclipse</TT> package available in your class path</A>
<LI><A HREF="embroot042.html#toc34">Compile and run <TT>QuickTest.java</TT></A>
</UL>

<A NAME="sec:ji-getting-started"></A>
At the end of this section you will run the simple Java program <TT>QuickTest.java</TT> which uses ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP>. First of all though
you need to check that your Java SDK version is recent enough and that
your classpath correctly set up.
<A NAME="toc32"></A>
<H3 CLASS="subsection"><A NAME="htoc73">8.1.1</A>&nbsp;&nbsp;Check your Java SDK version</H3>
Use of the Java-ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> Interface requires an installation of the
Java SDK (Standard Developer's Kit) version 1.2.2 or later. If your
Java SDK installation is an earlier version than this or you do not
have the Java SDK on your machine, the latest version can be
downloaded from Sun Microsystems Inc. (<A HREF="http://www.sun.com"><TT>http://www.sun.com</TT></A>).<BR>
<BR>
<A NAME="toc33"></A>
<H3 CLASS="subsection"><A NAME="htoc74">8.1.2</A>&nbsp;&nbsp;Make the <TT>com.parctechnologies.eclipse</TT> package available in your class path</H3>
The Java-ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> Interface consists mainly of a Java package which is
used as a library by the Java programs you will write. This package is
included as a <TT>.jar</TT> file located within the ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> distribution at:
<BLOCKQUOTE CLASS="quote">
<TT>&lt;eclipse_dir&gt;</TT><TT>/lib/eclipse.jar</TT></BLOCKQUOTE>
You are free to copy <TT>eclipse.jar</TT> to a more convenient
location. However, to compile or run any Java programs which use the
package you must include the full path of <TT>eclipse.jar</TT> in your
classpath<A NAME="@default163"></A>. For more information on using the classpath, please consult
your Java documentation.<BR>
<BR>
<A NAME="toc34"></A>
<H3 CLASS="subsection"><A NAME="htoc75">8.1.3</A>&nbsp;&nbsp;Compile and run <TT>QuickTest.java</TT></H3>
<A NAME="sec:ji-testing-ji"></A>
To test that everything is working as it should be, and to see a quick
example of the Java-ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> Interface at work, try compiling and
running the Java program <TT>QuickTest.java</TT>. This starts up an
ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> from Java and tells it to write a message to <TT>stdout</TT>. The
program can be found at
<BLOCKQUOTE CLASS="quote">
<A HREF="../examples/JavaInterface/QuickTest.java"><TT>&lt;eclipse_dir&gt;</TT><TT>/doc/examples/JavaInterface</TT><TT>/QuickTest.java</TT></A>
</BLOCKQUOTE>
After compilation, to run the program, start the Java interpreter as
you normally would but before the name of the class, supply the
command line option
<BLOCKQUOTE CLASS="quote">
<TT>-Declipse.directory=&lt;eclipse_dir&gt;</TT>
</BLOCKQUOTE>
This tells Java where to find the ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP> installation, so it can run
ECL<SUP><I>i</I></SUP>PS<SUP><I>e</I></SUP>. <B>You should use this command line options when running
all other examples in this document</B>. When you run <TT>QuickTest.java</TT>, you should get a single line of output: <TT>hello
world</TT>. How <TT>QuickTest.java</TT> works is explained in Section
<A HREF="embroot043.html#sec:ji-closer-look">8.2</A>.<BR>
<BR>
<HR>
<A HREF="embroot041.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="embroot043.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
